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SECTION 1 


MACRO-80 Assembler 


Assembly language programs and subroutines are assembled 
with MACRO-80. Just as the FORTRAN compiler generates 
relocatable object code from a FORTRAN program, MACRO-80 
generates relocatable object code from an assembly language 
program. Running MACRO-80 is very similar to running the 
FORTRAN compiler, and the command format is identical. The 
default extension for a MACRO-80 source file is /MAC. 


1.1 Running MACRO-80 
When you give TRSDOS the command 
M80 


(diskette #1 must be in the disk drive), you are 
running the MACRO-80 assembler. When the assembler 
is ready to accept commands, it prompts the user 
with an asterisk. To exit the assembler, use the 
<break> key. 


Command lines are also supported by MACRO-80. 
After executing a command line, the assembler 
automatically exits to the operating system. 


1210.4 Command Format 
An assembler command conveys the name of the source 
file you want to assemble, and what options you 
want to use... Here is the format for an assembler 


command (square brackets indicate optional): 


[object filename] [,listing filename]=source filename[-switch...] 


NOTE 
All filenames must be in TRSDOS filename 
format: 
filename[/ext] [.password] [:drive#]. If you 
are using the assembler's default 


extensions, it is not necessary to specify 
an extension in an assembler command. 
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Let's look individually at each part of the 
assembler command: 


1. 


Object filename 

To create a relocatable object file, this part 
of the command must be included, It is simply 
the name that you want to call the object file. 
The default extension for the object filename 
is /REL. 


Listing filename 

To create a listing file, this part of the 
command must be included, It is simply the 
name that you want to call the listing file. 
yer default extension for the listing file is 
LST. 


Source filename 

An assembler command must always include a 
source filename -- that is how the assembler 
"knows" what to assemble, It is simply the 
name of a MACRO-80 program you have saved on 
disk. The default extension for a MACRO-80 
source filename is /MAC. The source filename 
is always preceded by an equal sign in an 
assembler command, 


Examples (asterisk is typed by M80): 


*=TEST Assemble the program TEST/MAC 


without creating an object 
file or listing file. 


*TEST,TEST=TEST Assemble the program 


TEST/MAC. Create a reloca- 
table object file called 

. TEST/REL and a listing file 
called TEST/LST. 


*,TEST.PASS=TEST.PASS Assemble the program 


TEST/MAC.PASS and create a 
listing file called 
TEST/LST.PASS (No object 
file created.) 


*TESTOBJ=TEST Assemble the program TEST/MAC 


and create an object file 
called TESTOBJ/REL. (No 
listing file created.). 


Switch 

A switch on the end of a command specifies a 
special parameter to be used during assembly. 
Switches are always preceded by a dash (-). 
More than one switch may be used in the same 
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command. The available switches are: 
Switch Action 
{e) Print all listing addresses in 
octal, 
H Print all listing addresses in 
hexadecimal (default condition). 
c Force generation of a cross 
reference file. 
Z Assemble 280 (Zilog format) 
mnemonics (default condition). 
I Assemble 8080 mnemonics. 

Examples: 

*CT.ME,CT.ME=CT.ME-O Assemble the program 
CT/MAC.ME. Create a listing 
file called CT/LST.ME and 
an object file called 
CT/REL.ME. The addresses 
in the listing file will 
be in octal. : 

*LT,LT=LT-C Assemble the program LT/MAC. 


1.1.2 


Create an object file called 
LT/REL, a listing file 
called LT/LST, and a 

cross reference file called 
LT/CRF. (See Section 1.12.) 


Input/Output Device Names 


In the commands discussed so far, it is assumed 
that all files are read from and written to the 
disk. To use an I/O device other than the disk, 


specify the device name in place of the filename in 


the assembler command. 


The device names supplied by TRSDOS are: 


*KI 
*DO 
*PR 


Keyboard 


Input 


Display Output 
Printer Output 


(*DO and *PR are available only with TRSDOS Version 


2.2 or later.) 
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1.2 


1.2.1 


Examples: 


TEST, *PR=TEST Assemble the program TEST/MAC. 
Create an object file called 
TEST/MAC and output the 
listing file, TEST/LST, at 
the printer. 


TEST, *DO=TEST Assemble the program TEST/MAC. 
: Create an object file called 
TEST/MAC and output the 
listing file, TEST/LST at 
the. video display. 


7=*KI KI is used only if you 
want to input a source file 
from the keyboard. This 
command assembles the source 
file read from the 
keyboard without creating 
a REL or LST file. 


Format of MACRO-80 Source Files 
In general, MACRO-80 accepts a source file that is 
almost identical to source files for INTEL 
compatible assemblers. Input source lines of up to 
132 characters in length are acceptable. 


MACRO-80 preserves lower case letters in quoted 
strings and comments. All symbols, opcodes and 
pseudo-opcodes typed in lower case will be 
converted to upper case. 


NOTE 


If the source file iricludes line numbers 
from an editor, each byte of the line 
number must have the high bit on. Line 
numbers from Microsoft's EDIT-80 Editor are 
acceptable. 


Statements 


Source files input to MACRO-80 consist of 
statements of the form: ‘ 


[label:[:]] ‘[operator] [arguments] [:comment] 


With the exception of the ISIS assembler $ controls 
(see Section 1.10), it is not necessary that 
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statements begin in column 1. Multiple blanks or 
tabs may be used to improve readability. 


If a label is present, it is the first item in the 
statement and is immediately followed by a colon. 
If it is followed by two colons, it is declared as 
PUBLIC (see ENTRY/PUBLIC, Section 1.5.10). For 
exmple: 


FOO:: RET 
i, equivalent to 


PUBLIC FOO 
FOO: RET 


The next item after the label (or the first item on 
the line i, no label is present) is an operator. 
An operator may be an opcode (8080 or 280 
mnemonic), pseudo-op, macro call or expression. 
The evaluation order is as follows: 


1. Macro call 
2. Opcode/Pseudo operation 
3. Expression 


Instead of flagging an expression as an error, the 
assembler treats it as if it were a DB statement 
(see Section 1.5.4). 


The arguments following the operator will, of 
course, vary in form according to the operator. 


A comment always begins with a semicolon and ends 
with a carriage return. A comment may be a line by 
itself or it may be. appended to a line that 
contains a _ statement. Extended comments can be 
entered using the .COMMENT pseudo operation (see 
Section 1.5.19). 


1.2.2 Symbols 


MACRO-80 symbols may be of any length, however, 
only the first six characters are significant. The 
following characters are legal in a symbol: 


A-Z 0-9 $ . ? es x2 


The underline character is also legal in a_ symbol. 
A symbol may not start with a digit. When a symbol 
is read, lower case is translated into upper case. 
If a symbol reference is followed by ## it is 
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declared external (see also the EXT/EXTRN 
pseudo-op, Section 1.5.12). 


1.2.3 Numeric Constants 


“2 The default base for numeric constants is decimal. 
This may be changed by the .RADIX pseudo-op (see 
Section 1.5.21). Any base from 2 (binary) to 16 
(hexadecimal) may be selected. When the base is 
greater than 10, A-F are the digits following 9. 
If the first digit of the number is not numeric 
(i,e., A-F), the number must be preceded by a zero. 
This eliminates the use of zero as a leading digit 
for octal constants, as in “previous versions 
MACRO-80. 








Numbers are 16-bit unsigned quantities. A number 
is always evaluated in the current radix unless one 
of the following special notations is used: 


nnnnB Binary 

nnnnD Decimal 

nnnnO Octal 

nnnnQ Octal 

nnnnH Hexadecimal 
X'nnnn' Hexadecimal 


Overflow of a number beyond two bytes is ignored 
and the result is the low order 16-bits. 


A character constant is a string comprised of zero, 
one or two ASCII characters, delimited by quotation 
marks, and used in a non-simple expression. For 
example, in the statement 


DB ‘Ar +1 
'A' is a character constant. But the statement 
DB ‘A’ 


uses 'A' as a string because it is in a_ simple 
expression. The rules for character constant 
delimiters are the same as for strings. 


* A character constant comprised of one character has 
as its value the ASCII value of that character. 
That is, the high order byte of the value is, zero, 
and the low order byte is the ASCII value of the 
character. For example, the value of the constant 
‘A' is 41H. 


A character constant comprised of two characters 
has as its value the ASCII value of the first 
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character in the high order byte and the ASCII 
value of the second character in the low order 
byte. For example, the value of the character 


constant "AB" is 41H*256+42H. 
1.2.4 Strings 

A string is comprised of zero or more characters 
delimited by quotation marks. Either single or 
double quotes may be used as string delimiters. 
The delimiter quotes may be used as characters if 
they appear twice for every character occurrence 
desired. For example, the statement 

DB "I am ""great"" today" 
stores the string 

I am "great" today 

If there are zero characters between the 
delimiters, the string is a null string. 


1.3 Expression Evaluation 


1.3.1 Arithmetic and Logical Operators 


The following operators are allowed in expressions. 
The operators are listed in order of precedence. 


NUL 

LOW, HIGH 

*, /, MOD, SHR, “SHL 
Unary Minus | 

Woe 

EQ, NE, LT, LE, GT, GE 


NoT 


OR, XOR 


Parentheses are used to change the order of 
precedence. During evaluation of an expression, as 
soon aS a new operator is encountered that has 
precedence less than or equal to the last operator 
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encountered, all operations up to the new operator 
are performed. That is, subexpressions involving 
operators of higher precedence are computed first. 


All operators except +, -, *, / must be separated 
from their operands by at least one space. 


The byte isolation operators (HIGH, LOW) isolate 
the high or low order 8 bits of an Absolute 16-bit 
value. If a relocatable value is supplied as an 
operand, HIGH and LOW will treat it as if it were 
relative to location zero. 


1.3.2 Modes 


All symbols used as operands in expressions are in 
one of the following modes: Absolute, Data 
Relative, Program (Code) Relative or COMMON. (See 
Section 1.5 for the ASEG, CSEG, DSEG and COMMON 
pseudo-ops.) Symbols assembled under the ASEG, CSEG 
(default), or DSEG pseudo-ops are in Absolute, Code 
Relative or Data Relative mode respectively. The 
number of COMMON modes in a program is determined 
by the number of COMMON blocks that have been named 
with the COMMON pseudo-op. Two COMMON symbols are 
not in the same mode unless they are in the same 
COMMON block. 


In any operation other than addition or 
subtraction, the mode of both operands must be 
Absolute. 


If the operation is addition, the following rules 
apply: 


1. At least one of the operands must be Absolute. 
2. Absolute + <mode> = <mode> 


If the operation is subtraction, the following 
rules apply: 


1. <mode> - Absolute = <mode> 


2.  <mode> - <mode> = Absolute 
where the two <mode>s are the same. 


Each intermediate step in the evaluation of an 
expression must conform to the above rules for 
modes, or an error will be generated. For example, 
if FOO, BAZ and ZAZ are three Program Relative 
symbols, the expression 
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FOO + BAZ - ZAZ 


will generate an R error because the first step 
(FOO + BAZ) adds two relocatable values. (One of 
the values must be Absolute.) This problem can 
always be fixed by inserting parentheses. So that 


FOO + (BAZ - ZAZ) 


is legal because the first step (BAZ - ZAZ2) 
generates an Absolute value that is then added to 
the Program Relative value, FOO. 


1.3.3 Externals 


Aside from its classification by mode, a symbol is 
either External or not External. (See EXT/EXTRN, 
Section 1.5.12.) An External value must be 
assembled into a two-byte field. (Single-byte 
Externals are not supported.) The following rules 
apply to the use of Externals in expressions: 


1. Externals are legal only in addition and 
subtraction, 


2. If an External symbol is used in an expression, 
the result of the expression is always 
External, 


3. When the operation is addition, either operand 
(but not both) may be External. 


4. When the operation is subtraction, only the 
first operand may be External. 
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1.4 Opcodes as Operands 


8080 opcodes are valid one-byte operands. Note 
that only the first byte is a valid operand. For 


example: 
MVI A, (JMP) 
ADI (CPI) 
MVI B, (RNZ) 
CPI (INX H) 
ACI (LXI B) 


MVI C,MOV A,B 


Errors will be generated if more than one byte is 
included in the: operand -- such as (CPI 5), LXI 
B,LABEL1) or (JMP LABEL2). ° 


Opcodes used as one-byte operands need not be 
enclosed in parentheses, 


NOTE 


Opcodes are not valid operands in 280 mode, 


1.5 Pseudo Operations 


1.5.1 ASEG 
ASEG 


ASEG sets the location counter to an absolute 
segment of memory. The location of the absolute 
counter will be that of the last ASEG (default is 
0), unless an ORG is done after the ASEG to change 
the location. The effect of ASEG is also achieved 
by using the code segment (CSEG) pseudo operation 
and the -P switch in LINK-80. See also Section 
1.5.27. 


1.5.2 COMMON 
COMMON /<block name>/ 


COMMON sets the location counter to the selected 
common block in memory. The location is always the 
beginning of the area so that compatibility with 
the FORTRAN COMMON statement is maintained. If 
<block name> is omitted or consists of spaces, it 
is considered to be blank common. See also Section 
155275 
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1.5.3 CSEG 
CSEG 


CSEG sets the location counter to the code relative 
segment of memory. The location will be that of 
the last CSEG (default is 0), unless an ORG is done 
after the CSEG to change the location. CSEG is the 
default condition of the assembler (the INTEL 
assembler defaults to ASEG). See also Section 
1.5.27. 


1.5.4 Define Byte 
DB <exp>[,<exp>...] 
DB <string>[<string>...] 


The arguments to DB are either expressions or 
strings. DB stores the values of the expressions 
or the characters of the strings in successive 
memory locations beginning with the current 
location counter. 


Expressions must evaluate to one byte. (If the 
high byte of the result is 0 or 255, no error is 
given; otherwise, an A error results.) 


Strings of three or more characters may not be used 
in expressions (i.e., they must be immediately 
followed by a comma or the end of the line). The 
characters in a string are stored in the order of 
appearance, each as a one-byte value with the high 
order bit set to zero. 


Example: 
0000' 4142 DB "AB' 
0002' 42 DB ‘AB' AND OFFH 
0003' 41 42 43 DB "ABC! 


% S05 Define Character 
pc <string> 


DC stores the characters in <string> in successive 
memory locations beginning with the current 
location counter. As with DB, characters are 
stored in order of appearance, each as a one-byte 
value with the high order bit set to zero. 
However, DC stores the last character of the string 
with the high order bit set to one. An error will 
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1.5.6 


1.5.7 


1.5.8 


result if the argument to DC is a null string. 


Define Space 
DS <exp> 


DS reserves an area of memory. The value of <exp> 
gives the number of bytes to be allocated. All 
names used in <exp> must be previously defined 
(i.e., all names known at that point on pass 1). 
Otherwise, a V error is generated during pass 1 and 
a U error may be generated during pass 2. If aU 
error is not generated during pass 2, a phase error 
will probably be generated because the DS generated 
no code on pass 1. 


DSEG 
DSEG 


DSEG sets the location counter to the Data Relative 
segment of memory. The location of the data 
relative counter will be that of the last DSEG 
(default is 0), unless an ORG is done after the 
DSEG to change the location. See also Section 
1.5.27. 


Define Word 
DW <exp>[,<exp>...] 
DW stores the values of the expressions in 
successive memory locations beginning with the 
current location counter. Expressions are 
evaluated as 2-byte (word) values. 
END 
END [<exp>] 
The END statement specifies the end of the program. 
If <exp> is present, it is the start address of the 


program. If <exp> is not present, then no start 
address is passed to LINK-80 for that program. 
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1.5.10 ENTRY/PUBLIC 


ENTRY <name>[,<name>...] 
or 


PUBLIC <name>[,<name>...] 


ENTRY or PUBLIC declares each name in the list as 
internal and therefore available for use by this 
program and other programs to be loaded 
concurrently. All of the names in the list must be 
defined in the current program or a U error 
results. An M error is generated if the name is an 
external name or common-blockname. 


1.5.11 EQU 
<name> EQU <exp> 


EQU assigns the value of <exp> to <name>. If <exp> 
is external, an error is generated. If <name> 
already has a value other than <exp>, an M error is 
generated, 


1.5.12 EXT/EXTRN 


EXT <name>[,<name>...] 
or 
EXTRN <name>[,<name>...] 


EXT or EXTRN declares that the name(s) in the list 
are external (i.e., -defined in a different 
program). If any item in the list references a 
name that is defined in the current program, an M 
error results. A reference to a name where the 
name is followed immediately by two pound signs 
(e.g., NAME##) also declares the name as external. 


1.5.13 NAME 
NAME ("modname') 


NAME defines a name for the module. Only the first 
six characters are significant in a module name. A 
module name may also be defined with the TITLE 
pseudo-op. In the absence of both the NAME and 
TITLE pseudo-ops, the module name is created from 
the source file name. . 
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1.5.14 Define Origin 
ORG <exp> 


The location counter is set to the value of <exp> 
and the assembler assigns generated code starting 
with that value. All names used in <exp> must be 
known on pass 1, and the value must either be 
absolute or in the same area as the location 
counter. 


1.5.15 PAGE 
PAGE [<exp>] 


PAGE causes the assembler to start a new output 
page. The value of <exp>, if included, becomes the 
new page size (measured in lines per page) and must 
be in the range 10 to 255. The default page size 
is 50 lines per page. The assembler puts a_ form 
feed character in the listing file at the end of a 
page. 


1.5.16 SET 
<name> SET <exp> 


SET is the same as EQU, except no error is 
generated if <name> is already defined. 


1.5.17 SUBTTL 
SUBTTL <text> 


SUBTTL specifies a subtitle to be listed on the 
line after the title (see TITLE, Section 1.5.18) on 
each page heading. <text> is truncated after 60 
characters. Any number of SUBTTLs may be given in 
a program, 


5.18 TITLE 
TITLE <text> 


TITLE specifies a title to be listed on the first 
line of each page. If more than one TITLE is 
given, a Q error results. The first six characters 
of the title are used as the module name unless a 
NAME pseudo operation is used. If neither a NAME 
or TITLE pseudo-op is used, the module name is 
created from the source filename. 
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1.5.19 «COMMENT 
-COMMENT <delim><text><delim> 


The first non-blank character encountered after 
«COMMENT is the delimiter. The following <text> 
comprises a comment block which continues until the 
next occurrence of <delimiter> is encountered. For 
example, using an asterisk as the delimiter, the 
format of the comment block would be: 


«COMMENT * 
any amount of text entered 
here as the comment block 


a * 
;return to normal mode 


1.5.20 .PRINTX 
«PRINTX <delim><text><delim 


The first non-blank character encountered after 
-PRINTX is the delimiter. The following text is 
listed on the terminal during assembly until 
another occurrence of the delimiter is encountered. 
-PRINTX is useful for displaying progress through a 
long assembly or for displaying the value of 
conditional assembly switches. For example: 


IF CPM 2 
»PRINTX /CPM version/ 
ENDIF 


NOTE 
»PRINTX will output on both passes. If 


only one printout is desired, use the IF1 
or IF2 pseudo-op. 
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1.5.21 .RADIX 
«RADIX <exp> 


The default base (or radix) for all constants is 
decimal. The .RADIX statement allows the default 
radix to be changed to any base in the range 2 to 
16. For example: 


LXI H,OFFH 
«RADIX 16 
LXI H, OFF 


The two LXIs in the example are identical. The 
<exp> in a .RADIX statement is always in decimal 
radix, regardless of the current radix. 


1.5.22 ,.REQUEST 
»REQUEST <filename>[,<filename>...] 


«REQUEST sends a request to the LINK-80 loader to 
search the filenames in the list for undefined 
globals before searching the FORTRAN library. The 
filenames in the list should be in the form of 
legal MACRO-80 symbols. They should not include 
filename extensions or disk specifications. The 
LINK-80 loader will supply its default extension 
and will assume the currently selected disk drive. 


1.5.23 .280 


-Z80 enables the assembler to accept 2Z80 opcodes. 
This is the default condition. 280 mode may also 
be set by appending the Z switch to the MACRO-80 
command string -- see Section 1.1.2. 


1.5.24 .8080 


-8080 enables the assembler to accept 8080 opcodes. 
8080 mode may also be set by appending the I switch 
to the MACRO-80 command string -- see Section 
1.1.2. 
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1.5.25 Conditional Pseudo Operations 


The conditional pseudo operations are: 


IF/IFT <exp> True if <exp> is not 0. 
IFE/IFF <exp> True if <exp> is 0. 
IF1 True if pass 1. 
IF2 True if pass 2. 
. IFDEF <symbol> True if <symbol> is defined or 


has been declared External. 


IFNDEF <symbol> True if <symbol> is undefined 
or not declared External. 


IFB <arg> True if <arg> is blank. The 
angle brackets around <arg> 
are required. 


IFNB <arg> True if <arg> is not blank. 
Used for testing when dummy 
parameters are supplied. The 
angle brackets around <arg> 
are required. 


All conditionals use the following format: 


IFxx {argument] 


[ELSE 


ENDIF 


Conditionals may be nested to any level. Any 
argument to a conditional must be known on pass 1 
to avoid V errors and incorrect evaluation. For 
IF, IFT, IFF, and IFE the expression must involve 
values which were previously defined and the 
expression must be absolute. If the name is 
defined after an IFDEF or IFNDEF, pass 1 considers 
the name to be undefined, but it will be defined on 
pass 2. , 
ELSE 

Each conditional pseudo operation may optionally be 
used with the ELSE pseudo operation which allows 
alternate code to be generated when the opposite 
condition exists. Only one ELSE is permitted for a 
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given IF, and an ELSE is always bound to the most 
recent, open IF. A conditional with more than one 
ELSE or an ELSE without a conditional will cause a 


p C error. 
ENDIF 
Each IF must have a matching ENDIF to terminate the 
conditional. Otherwise, an ‘Unterminated 


conditional’ message is generated at the end of 
each pass. An ENDIF without a matching IF causes a 
C error. 


1.5.26 Listing Control Pseudo Operations 


Output to the listing file can be controlled by two 
pseudo-ops: 


«LIST and »XLIST 


If a listing is not being made, these pseudo-ops 
have no effect. .-LIST is the default condition. 
When a .XLIST is encountered, source and object 
code will not be listed until a .LIST is 
encountered, 


The output of cross reference information is 
controlled by .CREF and _ .XCREF. If the cross 
reference facility (see Section 1.12) has not been 
invoked, .CREF and .XCREF have no effect. The 
default condition is .CREF. When a_ .XCREF is 
encountered, no cross reference information is 
output until .CREF is encountered. 


The output of MACRO/REPT/IRP/IRPC expansions is 
controlled by three pseudo-ops: .LALL, .SALL, and 
-XALL. .LALL lists the complete macro text for all 
expansions. -SALL lists only the object code 
produced by a macro and not its text. .XALL is the 
default condition; it is similar to .SALL, except 
a source line is listed only if it generates object 
code. 


1.5.27 Relocation Pseudo Operations 


The ability to create relocatable modules is one of 
the major features of MACRO-80. Relocatable 
modules offer the advantages of easier coding and 
faster testing, debugging and modifying. In 
addition, it is possible to specify segments of 
assembled code that will later be loaded into RAM 
(the Data Relative segment) and ROM/PROM (the Code 
Relative segment). The psevdo operations that 
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select relocatable areas are CSEG and DSEG. The 
ASEG pseudo-op is used to generate non-relocatable 
(absolute) code. The COMMON pseudo-op creates a 
common data area for every COMMON block that is 
named in the program. 


The default mode for the assembler is Code 
Relative. That is, assembly begins with a CSEG 
automatically executed and the location counter in 
the Code Relative mode, pointing to location 0 in 
the Code Relative segment of memory. All 
subsequent instructions will be assembled into the 
Code Relative segment of memory until an ASEG or 
DSEG or COMMON pseudo-op is executed. For example, 
the first DSEG encountered sets the location 
counter to location zero in the Data Relative 
segment of memory. The following code is asembled 
in the Data Relative mode, that is, it is assigned 
to the Data Relative segment of memory. If a 
subsequent CSEG is encountered, the location 
counter will return to the next free location in 
the Code Relative segment and so on. 


The ASEG, DSEG, CSEG  pseudo-ops never have 
operands. If you wish to alter the current value 
of the location counter, use the ORG pseudo-op. 


ORG Pseudo-op 

At any time, the value of the location counter may 
be changed by use of the the ORG pseudo-op. The 
form of the ORG statement is: 


ORG <exp> 


where the value of <exp> will be the new value of 
the location counter in the current mode. All 
names used in <exp> must be known on pass 1 and the 
value of <exp> must be either Absolute or in the 
current mode of the location counter. For example, 
the statements © 


DSEG 
ORG 50 


set the Data Relative location counter to 50, 


of memory. 


LINK-80 

The LINK-80 linking loader (see Section 2° of this 
manual) combines the segments and creates each _ 
relocatable module in memory when the program is 
loaded. The origins of the relocatable segments 
are not fixed until the program is loaded and the 
origins are assigned by LINK-80. The command to 
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LINK-80 may contain user-specified origins through 
the use of the -P (for Code Relative) and -D (for 
Data and COMMON segments) switches. 


For example, a program that begins with the 
statements 


ASEG 
ORG 800H 


and is assembled entirely in Absolute mode will 
always load beginning at 800 unless the ORG 
statement is changed in the source file. However, 
the same program, assembled in Code Relative mode 
with no ORG statement, may be loaded at any 
specified address by appending the -P:<address> 
switch to the LINK-80 command string. 


1.5.28 Relocation Before Loading 
Two pseudo-ops, «PHASE and .DEPHASE, allow code to 
be located in one area, but executed only at a 


different, specified area. 


For example: 


0000' «PHASE 100H 
0100 CD 0106 FOO: CALL BAZ 
0103 C3 0007' JMP Z00 
0106 c9 BAZ: RET 

.«DEPHASE 
0007° c3 0005 Z00: JMP 5 


All labels within a .PHASE block are defined as the 
absolute value from the origin of the phase area. 
The code, however, is loaded in the current area 
(i.e., from 0" in this example). The code within 
the block can later be moved to 100H and executed. 


1.6 Macros and Block Pseudo Operations 


The macro facilities provided by MACRO-80 include 
- three repeat pseudo operations: repeat (REPT), 
indefinite repeat (IRP), and indefinite repeat 
character (IRPC). A macro definition operation 
(MACRO) is also provided. Each of these four macro 
operations is terminated by the ENDM ~ pseudo 
operation. . 


1.6.1 Terms 


For the purposes of discussion of macros and block 
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1.6.2 


operations, the following terms will be used: 


1. <dummy> is used to represent a dummy parameter. 
All dummy parameters are legal symbols that 
appear in the body of a macro expansion. 


2.  <dummylist> is a list of <dummy>s separated by 
commas, 


3. <arglist> is a list of arguments separated by 
commas, <arglist> must be delimited by angle 
brackets. Two angle brackets with no 
intervening characters (<>) or two commas with 
no intervening characters enter a null argument 
in the list. Otherwise an argument is a 
character or series of characters terminated by 
a comma or >. With angle brackets that are 
nested inside an <arglist>, one level of 
brackets is removed each time the bracketed 
argument is used in an <arglist>. (See 
example, Section 1.6.5.) A quoted string is an 
acceptable argument and is passed as_ such. 
Unless enclosed in brackets or a quoted string, 
leading and trailing spaces are deleted from 
arguments. 


4, <paramlist> is used to represent a list of 
actual parameters separated by commas. No 
delimiters are required (the list is terminated 
by the end of line or a comment), but the rules 
for entering null parameters and nesting 
brackets are the same as described for 
<arglist>. (See example, Section 1.6.5.) 


REPT-ENDM 


REPT <exp> 


ENDM 


The block of statements between REPT and ENDM is 
repeated <exp> times. <exp> is evaluated as a 
16-bit unsigned number. If <exp> contains any 
external or undefined terms, an error is generated. 
Example: 


SET 0 * 
REPT 10 ;generates DB1-DB10 
SET X+1 

DB x 


ENDM 
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1.6.3 IRP-ENDM 


IRP <dummy>,<arglist> 


ENDM 


The <arglist> must be enclosed in angle brackets. 
The number of arguments in the <arglist> determines 
the number of times the block of statements is 
repeated. Each repetition substitutes the next 
item in the <arglist> for every occurrence of 
<dummy> in the block, If the <arglist> is null 
(i.e., <>), the block is processed once with each 
occurrence of <dummy> removed. For example: 


IRP —-X,<1,2,3,4,5,6,7,8,9,10> 
DB x 
ENDM 


generates the same bytes as the REPT example. 


1.6.4 IRPC-ENDM 


IRPC <dummy>,string (or <string>) 


ENDM 


IRPC is similar to IRP but the arglist is replaced 
by a string of text and the angle brackets around 
the string are optional. The statements in the 
block are repeated once for each character in the 
string. Each repetition substitutes the next 
character in the string for every occurrence of 
<dummy> in the block. For example: 


IRPC X,0123456789 
DB X+1 
ENDM 


generates the same code as the two previous 
Pa examples, 


1.6.5 MACRO 


Often it is convenient to be able to generate a 
given sequence of statements from various places in 
a program, even though different parameters may be 
required each time the sequence is used. This 
capability is provided by the MACRO statement. The 
form is 
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<name> MACRO <dummylist> 


ENDM 


where <name> conforms to the rules for forming 
symbols. <name> is the name that will be used to 
invoke the macro. The <dummy>s in <dummylist> are 
the parameters that will be changed (replaced) each 
time the MACRO is invoked. The statements before 
the ENDM comprise the body of the macro. During 
assembly, the macro is expanded every time it is 
invoked but, unlike REPT/IRP/IRPC, the macro is not 
expanded when it is encountered. 


The form of a macro call is 
<name> <paramlist> 


where <name> is the name supplied in the MACRO 
definition, and the parameters in <paramlist> will 
replace the <dummy>s in the MACRO <dummylist> on a 
one-to-one basis. The number of items in 
<dummylist> and <paramlist> is limited only by the 
length of a line. The number of parameters used 
when the macro is called need not be the same as 
the number of <dummy>s in <dummylist>. If there 
are more parameters than <dummmy>s, the extras are 
ignored. If there are fewer, the extra <dummy>s 
will be made null. The assembled code will contain 
the macro expansion code after each macro call. 


NOTE 


A dummy parameter in a MACRO/REPT/IRP/IRPC 
is always recognized exclusively as a 
dummmy parameter. Register names such as A 
and B will be changed in the expansion if 
they were used as dummy parameters. 
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Here is an example of a MACRO definition that 
defines a macro called FOO: 


FOO MACRO X 


Y SET 0 
REPT x 
x SET Y+1 
DB Y 
ENDM 
ENDM 


This macro generates the same code as the previous 
three examples when the call 


FOO 10 
is executed, 
Another example, which generates the same code, 
illustrates the removal of one level of brackets 
when an argument is used as an arglist: 

FOO MACRO X 

IRP Y,<xX> 

DB Y 

ENDM 

ENDM 
When the call 

FOO <1,2,3,4,5,6,7,8,9,10> 
is made, the macro expansion looks like this: 

IRP Y¥,<1,2,3,4,5,6,7,8,9,10> 

DB x 

ENDM 


1.6.6 ENDM 





Every REPT, IRP, IRPC and MACRO pseudo-op must be 
terminated with the ENDM pseudo-op. Otherwise, the 
‘Unterminated REPT/IRP/IRPC/MACRO' message is 
generated at the end of each pass. An unmatched 
ENDM causes an O error. 


1.6.7 EXITM 


The EXITM pseudo-op is used to terminate a 
REPT/IRP/IRPC or MACRO call. When an EXITM is 
executed, the expansion is exited immediately and 
any remaining expansion or repetition is not 
generated. If the block containing the EXITM is 
nested within another block, the outer level 


Microsoft Utility Software Page 29 


1.6.8 


1.6.9 


continues to be expanded. 


LOCAL 
LOCAL <dummylist> 


The LOCAL pseudo-op is allowed only inside a MACRO 
definition. When LOCAL is executed, the assembler 
creates a unique symbol for each <dummy> in 
<dummylist> and substitutes that symbol for each 
occurrence of the <dummy> in the expansion. These 
unique symbols are usually used to define a label 
within a macro, thus eliminating multiply-defined 
labels on successive expansions of the macro. The 
symbols created by the assembler range from ..0001 
to ..FFFF. Users will therefore want to avoid the 
form ..nnnn for their own’ symbols. If LOCAL 
statements are used, they must be the first 
statements in the macro definition. 


Special Macro Operators and Forms 


& The ampersand is used in a macro expansion to 
concatenate text or symbols. A dummy 
parameter that is in a quoted string will not 
be substituted in the expansion unless it is 
immediately preceded by & To form a _ symbol 
from text and a dummy, put & between them. 
For example: 


ERRGEN MACRO x 
ERROR&X: PUSH B 


MVI B,'&x' 
JMP ERROR 
ENDM 


In this example, the call ERRGEN A will 
generate: 


ERRORA: PUSH B 


MVI B,'A' 
JMP ERROR 
ai In a block operation, a comment preceded by 


two semicolons is not saved as part of the 
expansion (i.e., it will not appear on the 
listing even under .LALL). A comment preceded 
by one semicolon, however, will be ‘° preserved 
and appear in the expansion. 


When an exclamation point is used in an 
argument, the next character is entered 
literally (i.e., !; and <;> are equivalent). 
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1.7 


NUL NUL is an operator that returns true if its 
argument (a parameter) is null. The remainder 
of a line after NUL is considered to be the 
argument to NUL. The conditional 


IF NUL argument 


is false if, during the expansion, the first 
character of the argument is anything other 
than a semicolon or carriage return. Lt. is 
recommended that testing for null parameters 
be done using the IFB and IFNB conditionals. 


Using 280 Pseudo-ops 


The following 280 pseudo-ops are valid. The 
function of each pseudo-op is equivalent to that of 
its 8080 counterpart. 


280 pseudo-op Equivalent 8080 pseudo-op 
COND IFT 
ENDC ENDIF 
*EJECT PAGE 
DEFB DB 
DEFS DS 
DEFW DW 
DEFM DB 
DEFL SET 
GLOBAL PUBLIC 
EXTERNAL EXTRN 


The formats, where different, conform to the 8080 
format. That is, DEFB and DEFW are permitted a 
list of arguments (as are DB and DW), and DEFM is 
permitted a string or numeric argument (as is DB). 
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1.8 Sample Assembly 


DOS READY 
M80 
*EXMPL1,TTY:=EXMPL1 
MAC80 3.2 PAGE 
0000' 7E 
0001" 23 
0002" 66 
0003' 6F 
0004' 06 03 
0006" AF 
0007" 29 
0008' 17 
0009" 85 
000A' 6F 
0ooB' 05 
oooc' C2 0006' 
OOOF' EB 
0010" 73 
0011" 23 
0012' 72 
0013' co 
MAC80 3.2 PAGE 


CSL3 0000I' Loop 0006' 


No Fatal error(s) 
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;CSL3(P1,P2) 
;SHIFT P1 LEFT CIRCULARLY 3 BITS 
;RETURN RESULT IN P2 

ENTRY  CSL3 
;GET VALUE OF FIRST PARAMETER 
CSL3: 


MOV AM 

INX H 

MOV HM 

MOV LA 
;SHIFT COUNT 

MVI B,3 
LOOP:  XRA A 
;SHIFT LEFT 

DAD H 
;ROTATE IN CY BIT 

RAL 

ADD L 

MOV L,A 
;DECREMENT COUNT 

DCR B 
;ONE MORE TIME 

INZ LOOP 

XCHG 
;SAVE RESULT IN SECOND PARAMETER 

MOV M,E 

INX H 

MOV M,D 

RET 

END 
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1.9 MACRO-80 Errors 


MACRO-80 errors are indicated by a one-character 
flag in column one of the listing file. If a 
listing file is not being printed on the terminal, 
each erroneous line is also printed or displayed on 


the terminal. Below is a list of the MACRO-80 
Error Codes: 


A Argument error 
Argument to pseudo-op is not in correct format 
or is out of range (.PAGE 1; »RADIX 1; 
PUBLIC 1; STAX H; MOV M,M; INX C). 


Cc Conditional nesting error 
ELSE without IF, ENDIF without IF, two ELSEs 
on one IF, 


D Double Defined symbol 
Reference to a symbol which is multiply 
defined, 


E External error 
Use of an external illegal in context (e.g., 
FOO SET NAME##; MVI A,2-NAME##). 


M Multiply Defined symbol 
Definition of a symbol which is multiply 
defined. 


N Number error 
Error in a number, usually a bad digit (e.g., 
8Q). 


fe) Bad opcode or objectionable syntax 
ENDM, LOCAL outside a _ block; SET, EQU or 
MACRO without a name; bad syntax in an opcode 
(MOV A:); or bad syntax in an expression 
(mismatched parenthesis, quotes, consecutive 
operators, etc.). 


P Phase error 
Value of a label or EQU name is different on 
pass 2. 

Q Questionable 
Usually means a line is not terminated 
properly. This is a warning error (e.g. MOV 
A,;B,).< 

R Relocation 
Illegal use of relocation in expression, such 
as abs-rel. Data, code and COMMON areas are 


relocatable. 
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U Undefined symbol 
A symbol referenced in an expression is not 
defined. (For certain pseudo-ops, a V error 
is printed on pass 1 and a U on pass 2.) 


Vv Value error 
On pass 1 a pseudo-op which must have its 
value known on pass 1 (e.g., -RADIX, .PAGE, 
DS, IF, IFE, etc.), has a value which is 
undefined, If the symbol is defined later in 
the program, a U error will not appear on the 
pass 2 listing. 


Error Messages: 


"No end statement encountered on input file' 
No END statement: either it is missing or it 
is not parsed due to being in a false 
conditional, unterminated IRP/IRPC/REPT block 
or terminated macro. 


‘Unterminated conditional' 
At least one conditional is unterminated at 
the end of the file. 


‘Unterminated REPT/IRP/IRPC/MACRO' 
At least one block is unterminated. 


[xx] [No] Fatal error(s) [,xx warnings] 
The number of fatal errors and warnings. The 
message is listed on the CRT and in the list 
file. 


1.10 Compatibility with Other Assemblers 
The $EJECT and $TITLE controls are provided for 
compatability with INTEL's ISIS assembler. The 
dollar sign must appear in column 1 only if spaces 
or tabs separate the dollar sign from the control 
word. The control 


$EJECT 


is the same as the MACRO-80 PAGE pseudo-op. 
The control 


$TITLE ('text') 


is the same as the MACRO-80 SUBTTL <text> 
pseudo-op. 


The INTEL operands PAGE and INPAGE generate Q 
errors when used with the MACRO-80 CSEG or DSEG 
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1.11 


pseudo-ops,. These errors are warnings; the 
assembler ignores the operands. 


When MACRO-80 is entered, the default for the 
origin is Code Relative 0. With the INTEL ISIS 
assembler, the default is Absolute 0. 


With MACRO-80, the dollar sign ($) is a defined 
constant that indicates the value of the location 
counter at the start of the statement. Other 
assemblers may use a decimal point or an asterisk. 
Other constants are defined by MACRO-80 to have the 
following values: 


A: 
H 


7 B=0 Cc 
4 =5 M: 


Format of Listings 


On each page of a MACRO-80 listing, the first two 
lines have the form: 


[TITLE text] MAC80 3.2 PAGE x[-y] 
[SUBTTL text] 


where: 


1. TITLE text is the text supplied with the TITLE 
pseudo-op, if one was given in the source 
program, 


2. x* dis the major page number, which is 
incremented only when a form feed is 
encountered in the source file. (When using 
Microsoft's EDIT-80 text editor, a form feed is 
inserted whenever a page mark is done.) When 
the symbol table is being printed, x = 'S'. 


3. y is the minor page number, which is 
incremented whenever the .PAGE pseudo-op is 
encountered in the source file, or whenever the 
current page size has been filled. 


4, SUBTTL text is the text supplied with the 
SUBTTL pseudo-op, if one was given in the 
source program, 


Next, a blank line is printed, followed by the 
first line of output. . 


A line of output on a MACRO-80 listing has the 
following form: 


[crf#] {error] loc#m xx XXXX -se:0 source 
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if cross reference information is being output, the 
first item on the line is the cross reference 
number, followed by a tab. 


A one-letter error code followed by a space appears 
next on the line, if the line contains an error. 
If there is no error, a space is printed. If there 
is no cross reference number, the error code column 
is the first column on the listing. 


The value of the location counter appears next on 
the line. It is a 4-digit hexadecimal number of 
6-digit octal number, depending on whether the -O 
or -H switch was given in the MACRO-80 command 
string. 


The character at the end of the location counter 
value is the mode indicator. It will be one of the 
following symbols: 


. Code Relative 


id Data Relative 

! COMMON Relative 
<space> Absolute 

* External 


Next, three spaces are printed followed by the 
assembled code. One-byte values are followed by a 
space. Two-byte values are followed by a mode 
indicator. Two-byte values are printed in the 
opposite order they are stored in, i.e., the high 
order byte is printed first. Externals are either 
the offset or the value of the pointer to the next 
External in the chain. 


The remainder of the line contains the line of 
source code,.as it was input. 


1.11.1 Symbol Table Listing 


In the symbol table listing, all the macro names in 
the program are listed alphabetically, followed by 
all the symbols in the program, listed 
alphabetically. After each symbol, a tab is 
printed, followed by the value of the symbol. If 
the symbol is Public, an I is printed immediately 
after the value. The next character printed will 
be one of the following: 


Microsoft Utility Software Page 36 


U Undefined symbol. 


c COMMON block name, (The "value" of the 
COMMON block is its length (number of 
bytes) in hexadecimal or octal.) 


* External symbol. 


<space> Absolute value. 


. Program Relative value. 


Data Relative value. 


! COMMON Relative value. 


1.12 Cross Reference Facility 


The Cross Reference Facility is invoked by typing 
CREF80 at TRSDOS command level. In order to 
generate a cross reference listing, the assembler 
must output a special listing file with embedded 
control characters. The MACRO-80 command string 
tells the assembler to output this special listing 
file. (See Section 1.5.26 for the .CREF and .XCREF 
pseudo-ops.) -C is the cross reference switch. 
When the -C switch is encountered in a MACRO-80 
command string, the assembler opens a /CRF file 
instead of a /LST file. 


Examples: 


*=TEST-C Assemble file TEST/MAC and 
create object file TEST/REL 
and cross reference file 
TEST/CRF. 


*T,U=TEST-C Assemble file TEST/MAC and 
create object file T/REL 
and cross reference file 
U/CRF. 


When the assembler is finished, it is necessary to 
- call the cross reference facility by typing CREF80. 
(CREF80 is on diskette #1) CREF80 command format is: 


*listing file=source file 


The default extension for the source file is /CRF. 
the -L switch is ignored, and any other switch will 
cause an error message to be sent to the terminal. 
Possible command strings are: 
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*=TEST Examine file TEST/CRF and 
generate a cross reference 
listing file TEST/LST. 


*T=TEST Examine file TEST/CRF and 
generate a cross reference 
listing file T/LST. 


Cross reference listing files differ from ordinary 
listing files in that: 


1. 


2. 


Each source statement is numbered with a_ cross 
reference number. 


At the end of the listing, variable names 
appear in alphabetic order along with the 
numbers of the lines on which they are 
referenced or defined. Line numbers on which 
the symbol is defined are flagged with '#'. 
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SECTION 2 


LINK-80 Linking Loader 


The LINK-80 Linking Loader takes the relocatable object 
files generated by the FORTRAN compiler and MACRO-80 
assembler and loads them into memory in a form that can be 
executed, In addition, LINK-80 automatically searches the 
system library (FORLIB) and loads the library routines 
needed to satisfy any undefined global references (i.e., 
calls generated by the compiled program to subroutines in 
the system library). 


LINK-80 provides the user with several loading options. 
Programs may be loaded at user-specified locations, and 
program areas and data areas may be separated in memory. A 
memory image of the executable file produced by LINK-80 can 
be written to disk. The default extension for the name of 
the executable file is /CMD. 


2.1 Running LINK-80 
When you give TRSDOS the command 
L80 


(diskette #2 must be in the disk drive), you are 
running the LINK-80 linking loader. When the 
loader is ready to accept commands, it prompts the 
user with an asterisk. The loader will exit back 
to TRSDOS after a command containing an E or G 
switch (see Section 2.1.1), or after a <break> is 
done at command level. 


Command lines are also supported by LINK-80. 


2.1.1 LINK-80 Commands 


A command to LINK-80 consists of a string of 
filenames and/or switches. The command format is: 


[filename1] [-switch1] [,filename2] [-switch2]... 

All filenames must be in TRSDOS filename format. 
After LINK-80 receives the command, it will-load or 
search (see the S switch) the specified files. 


Then it will list all the symbols that remained 
undefined, with each followed by an asterisk. 
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Example: 

*MAIN 

DATA 5200 5300 

SUBR1* (SUBR1 is undefined) 
DATA 5200 5300 


*SUBR1 
*-G (Starts Execution - see below) 


Typically, to execute a FORTRAN program and 
subroutines, the user types the list of filenames 
followed by -G (begin execution). Before execution 
begins, LINK-80 will always search the system 
library (FORLIB/REL) to satisfy any unresolved 
external references. If you wish to first search 
libraries of your own, append the filenames that 
are followed by -S to the end of the loader command 
string. 


2.1.2 LINK-80 Switches 


A number of switches may be given in the LINK-80 
command string to specify actions affecting the 
loading process. Each switch must be preceded by a 
dash (-). These switches are: 


Switch Action 
R Reset. Put loader back in its 


initial state. Use -R if you 
loaded the wrong file by mistake 
and want to restart. -R takes 
effect as soon as it is encountered 
in a command string. 


E or E:Name Exit LINK-80 and return to the 
Operating System. The system 
library will be searched on the 
current dsk to satisfy any existing 
undefined globals. The optional 
form E:Name (where Name is a global 
symbol previously defined in one of 
the modules) uses Name for the 
start address of the program. Use 
-E to load a program and éxit back 
to the monitor. 


G or G:Name Start execution of the program as 
soon as the current command line 
has been interpreted. The system 
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P and D 


library will be searched on the 
current disk to satisfy any 
existing undefined globals. Before 
execution actually begins, LINK-80 
prints two numbers and a _ BEGIN 
EXECUTION message. The two numbers 
are the start address and _ the 
address of the next available byte. 
The optional form G:Name (where 
Name is a global symbol previously 
defined in one of the modules) uses 
Name for the start address of the 
program, 


If a <filename>-N is specified, the 
program will be saved on disk under 
the selected name (with a default 
extension of CMD) when a -E or -G 
is done. 


-P and -D allow the origin(s) to be 
set for the next program loaded. 
-P and -D take effect when seen 
(not deferred), and they have no 
effect on programs already loaded. 
The form is -P:<address> or 
-D:<address>, where <address> is 
the desired origin in the current 
typeout radix. (Default radix is 
hexadecimal. -O sets radix to 
octal; -H to hex.) LINK-80 does a 
default -P:<link origin> (i.e., 
5200). 


If no -D is given, data areas are 


‘loaded before program areas for 


each module. If a -D is given, all 
Data and Common areas are loaded 
starting at the data origin and the 
program area at the program origin. 
Example: 


*-P:200,FOO 
Data 200 300 


*-R 

*-P:200 -D:400,FOO 

Data 400 480 
Program 200 280 . 


List the origin and end of the pro- 
gram and data area and all 
undefined globals as_ soon as the 
current command line has been 
interpreted. The program informa- 
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tion is only printed if a -D has 
been done. Otherwise, the program 
is stored in the data area. 


M List the origin and end of the pro- 
gram and data area, all defined 
globals and their values, and all 
undefined globals followed by an 
asterisk. The program information 
is only printed if a -D has been 
done. Otherwise, the program is 
stored in the data area. 


s Search the filename immediately 
preceding the -S in the command 
string to satisfy any undefined 
globals. 

Examples: 


*-M List all globals 


*MYPROG , SUBROT ,MYLIB-S 
Load MYPROG.REL and SUBROT.REL and 
then search MYLIB.REL to satisfy 
any remaining undefined globals. 


*-G Begin execution of main program 
2.2 Sample Link 

DOS READY 

L80 

*EXAMPL,EXMPL1-G 

DATA 5200 52AC 


[5200 52AC] 
[BEGIN EXECUTION] 


1792 14336 
14336 -16383 
-16383 14 
14 112 

112 896 


DOS READY 


Microsoft Utility Software Page 42 


2.3 Format of LINK Compatible Object Files 


NOTE 


Section 2.3 is reference material for users 
who wish to know the load format of LINK-80 
relocatable object files. Most users will 
want to skip this section, as it does not 
contain material necessary to the operation 
of the package. 


LINK-compatible object files consist of a bit 
stream. Individual fields within the bit stream 
are not aligned on byte boundaries, except as noted 
below. Use of a bit stream for relocatable object 
files keeps the size of object files to a minimum, 
thereby decreasing the number of disk reads/writes. 


There are two basic types of load items: Absolute 
and Relocatable, The first bit of an item 
indicates one of these two types. If the first bit 
is a 0, the following 8 bits are loaded as an 
absolute byte. If the first bit is a 1, the next 2 
bits are used to indicate one of four types of 
relocatable items: 


00 Special LINK item (see below). 

01 Program Relative, Load the following 16 
bits after adding the current Program 
base. 

10 Data Relative. Load the following 16 
bits after adding the current Data base. 

11 Common Relative. Load the following 16 
bits after adding the current Common 
base. 


Special LINK items consist of the bit stream 100 
- followed by: 


a four-bit control field 


an optional A field consisting 
of a two-bit address type that 
is the same as the two-bit field 
above except 00 specifies 
absolute address 


an optional B field consisting 
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of 3 bits that give a symbol 
length and up to 8 bits for 
each character of the symbol 


A general representation of a special LINK item is: 





1 00 xxxx yy nn 2zz + characters of symbol name 
A field 

XXXX Four-bit control field (0-15 below) 

yy Two-bit address type field 

nn Sixteen-bit value 

Z2z Three-bit symbol length field 


The following special types have a B-field only: 


Entry symbol (name for search) 
Select COMMON block 

Program name 

Request library search 
Reserved for future expansion 


&WNO 


The following special LINK items have both an A 
field and a B field: 


5 Define COMMON size 

6 Chain external (A is head of address chain, 
B is name of external symbol) 

7 Define entry point (A is address, B is name) 

8 Reserved for future expansion 


The following special LINK items have an A field 


only: 

9 External + offset. The A value will 
be added to the two bytes starting 
at the current location counter 
immediately before execution. 

10 Define size of Data area (A is size) 

11 Set loading location counter to A 

12 Chain address. A is head of chain, 
replace all entries in chain with current 
location counter. 
The last entry in the chain has an 
address field of absolute zero. 

13 Define program size (A is size) 

14 End program (forces to byte boundary) 


The following special Link item has neither an A nor 
a B field: 


15 End file 
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LINK-80 Error Messages 
LINK-80 has the following error messages: 


?No Start Address A -G switch was issued, 
but no main program 
had been loaded. 


?Loading Error The last file given for input 
was not a properly formatted 
LINK-80 object file. 


?0ut of Memory Not enough memory to load 
program, 

?Command Error Unrecognizable LINK-80 
command, 

?<file> Not Found <file>, as given in the command 


string, did not exist, 


%2nd COMMON Larger /XXXXXX/ 
The first definition of 
COMMON block /XXXXXX/ was not 
the largest definition. Re- 
order module loading sequence 
or change COMMON block 
definitions, 


%Mult, Def, Global YYYYYY 
More than one definition for 
the global (internal) symbol 
YYYYYY was encountered during 
the loading process, 


Data Public = <symbol name> (xxxx) 
,External = <symbol name> (xxxx) 
A -D or -P will cause already 
loaded data to be destroyed. 


sOverlaying (eee Area [:sebit = XxXxx 


?Intersecting (ear Area 
Data 

The program and data area 
intersect and an address or 
external chain entry is in 
this intersection, The 
final value cannot be con- 
verted to a current value 
since it is in the area 
intersection, 
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?Start Symbol - <name> - Undefined 
After a -E: or -G: is given, 
the symbol specified was not 
defined. 


Origin [ere] Loader Memory, Move Anyway (Y or N)? 
Below 

After a -E or -G was given, 
either the data or program 
area has an origin or top 
which lies outside loader 
memory (i.e., loader origin 
to top of memory). Ifa 
Y <cr> is given, LINK-80 
will move the area and con- 
tinue. If anything else is 
given, LINK-80 will exit. 
In either case, if a -N was 
given, the image will already 
have been saved. 


?Can't Save Object File 
A disk error occurred when 
the file was being saved. 


Program Break Information 


LINK-80 stores the address of the first free 
location in a global symbol called $MEMRY if that 
symbol has been defined by a program loaded. 
$MEMRY is set to the top of the data area +1. 


NOTE 


If -D is given and the data origin is less 
than the program area, the user must be 
sure there is enough room to keep the 
program from being destroyed. This is 
particularly true with the disk driver for 
FORTRAN-80 which uses $MEMRY to allocate 
disk buffers and FCB's. , 
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